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Overview 


This document describes all the changes that have been made for LiveCode 6.6.2, including bug fixes and 
new syntax. 


Known issues 


e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


Platform support 


The engine supports a variety of operating systems and versions. This section describes the platforms that 
we ensure the engine runs on without issue (although in some cases with reduced functionality). 


Windows 
The engine supports the following Windows OSes: 


e Windows XP SP2 and above 

e Windows Server 2003 

e Windows Vista SP1 and above (both 32-bit and 64-bit) 
e Windows 7 (both 32-bit and 64-bit) 

e Windows Server 2008 

e Windows 8.x (Desktop) 


Note: On 64-bit platforms the engine still runs as a 32-bit application through the WoW layer. 


Linux 
The linux engine requires the following: 


e 32-bit installation, or a 64-bit linux distribution that has a 32-bit compatibility layer 

e 2.4.x or later kernel 

e X11R5 capable Xserver running locally on a 24-bit display 

e glibc 2.3.2 or later 

e gtk/gdk/glib (optional — required for native theme support) 

e pango/xft (optional — required for pdf printing, anti-aliased text and unicode font support) 
e Icms (optional — required for color profile support in JPEGs and PNGs) 

e gksu (optional — required for elevate process support) 


Note: The optional requirements (except for gksu and Icms) are also required by Firefox and Chrome, so if 
your linux distribution runs one of those, it will run the engine. 

Note: If the optional requirements are not present then the engine will still run but the specified features will 
be disabled. 

Note: LiveCode and standalones it builds may work on remote Xservers and in other bit-depths, however 
this mode of operation is not currently supported. 
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Mac 
The Mac engine supports: 


e 10.5.8 and later (Leopard) on Intel and PowerPC 
e 10.6.x (Snow Leopard) on Intel 

e 10.7.x (Lion) on Intel 

e 10.8.x (Mountain Lion) on Intel 

e 10.9.x (Mavericks) on Intel 


Note: The engine runs as a 32-bit application regardless of the capabilities of the underlying processor. 
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Setup 


Installation 


Each distinct version has its own complete folder — multiple versions will no longer install side-by-side: on 
Windows (and Linux), each distinct version will gain its own start menu (application menu) entry; on Mac, 
each distinct version will have its own app bundle. 

The default location for the install on the different platforms when installing for ‘all users’ are: 


e Windows: <x86 program files folder>/RunRev/ LiveCode 6.6.2 
e Linux: /opt/runrev/livecode-6.6.2 
e Mac: /Applications/ LiveCode 6.6.2.app 


The default location for the install on the different platforms when installing for 'this user’ are: 


e Windows: <user roaming app data folder>/RunRev/Components/LiveCode 6.6.2 
e Linux: ~/.runrev/components/livecode-6.6.2 
e Mac: ~/Applications/ LiveCode 6.6.2.app 


Note: If your linux distribution does not have the necessary support for authentication (gksu) then the 
installer will run without admin privileges so you will have to manually run it from an admin account to install 
into a privileged location. 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible from 
the appropriate pane in the control panel. 

On Mac, simply drag the app bundle to the Trash. 

On Linux, the situation is currently less than ideal: 


e open a terminal 
e cd to the folder containing your rev install. e.g. 


cd /opt/runrev/livecode-6.6.2 
e execute the .sefup.x86 file. i.e. 
./.setup.x86 


e follow the on-screen instructions. 


Reporting installer issues 


If you find that the installer fails to work for you then please file a bug report in the RQCC or email 
support@runrev.com so we can look into the problem. 
In the case of failed install it is vitally important that you include the following information: 


e Your platform and operating system version 

e The location of your home/user folder 

e The type of user account you are using (guest, restricted, admin etc.) 

e The installer log file located as follows: 

e Windows 2000/XP: <documents and settings folder>/<user>/Local Settings/ 
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e Windows Vista/7: <users folder>/<user>/AppData/Local/RunRev/Logs 
e Linux: <home>/.runrev/logs 
e Mac: <home>/Library/Application Support/Logs/RunRev 


Activation 


The licensing system ties your product licenses to a customer account system, meaning that you no longer 
have to worry about finding a license key after installing a new copy of LiveCode. Instead, you simply have 
to enter your email address and password that has been registered with our customer account system and 
your license key will be retrieved automatically. 

Alternatively it is possible to activate the product via the use of a specially encrypted license file. These will 
be available for download from the customer center after logging into your account. This method will allow 
the product to be installed on machines that do not have access to the internet. 


Multi-user and network install support (4.5.3) 


In order to better support institutions needing to both deploy the IDE to many machines and to license them 
for all users on a given machine, a number of facilities have been added which are accessible by using the 
command-line. 

Note: These features are intended for use by IT administrators for the purposes of deploying LiveCode in 
multi-user situations. They are not supported for general use. 


Command-tine installation 


It is possible to invoke the installer from the command-line on both Mac and Windows. When invoked in this 
fashion, no GUI will be displayed, configuration being supplied by arguments passed to the installer. 
On both platforms, the command is of the following form: 


<exe> install noui options 


Here options is optional and consists of one or more of the following: 


Install the IDE for all users. If not specified, the install will be done for the current 


-allusers 
user only. 
aecveenatalh Place a shortcut on the Desktop (Windows-only) 
-Startmenu Place shortcuts in the Start Menu (Windows-only) 
-location The location to install into. If not specified, the location defaults to those 
location described in the Layout section above. 
-log logfile A file to place a log of all actions in. If not specified, no log is generated. 


Note that the command-line variant of the installer does not do any authentication. Thus, if you wish to 
install to an admin-only location you will need to be running as administrator before executing the command. 
As the installer is actually a GUI application, it needs to be run slightly differently from other command-line 
programs. 

In what follows <installerexe> should be replaced with the path of the installer executable or app (inside the 
DMG) that has been downloaded. 

On Windows, you need to do: 


start /wait <installerexe> install noui options 
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On Mac, you need to do: 
“<installerexe>/Contents/MacOS/installer’ install noui options 


On both platforms, the result of the installation will be written to the console. 


Command-line activation 


In a similar vein to installation, it is possible to activate an installation of LiveCode for all-users of that 
machine by using the command-line. When invoked in this fashion, no GUI will be displayed, activation 
being controlled by any arguments passed. 

On both platforms, the command is of the form: 


<exe> activate -file /icense -passphrase phrase 


This command will load the manual activation file from license, decrypt it using the given passphrase and 
then install a license file for all users of the computer. Manual activation files can be downloaded from the 
‘My Products’ section of the RunRev customer accounts area. 

This action can be undone using the following command: 


<exe> deactivate 


Again, as the LiveCode executable is actually a GUI application it needs to be run slightly differently from 
other command-line programs. 

In what follows <livecodeexe> should be replaced with the path to the installed LiveCode executable or app 
that has been previously installed. 

On Windows, you need to do: 


start /wait <livecodeexe> activate -file /icense -passphrase phrase 
start /wait <livecodeexe> deactivate 


On Mac, you need to do: 


“<livecodeexe>/Contents/MacOS/LiveCode’” activate -file license -passphrase phrase 
“<livecodeexe>/Contents/MacOS/LiveCode’” deactivate 


On both platforms, the result of the activation will be written to the console. 


Proposed changes 


The following changes are likely to occur in the next or subsequent non-maintenance release: 


e The engine (both IDE and standalone) will require gtk, gdk, glib, pango and xft on Linux 
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Engine changes 


Normal resizeQuality is slow (6.6.2) 


As part of the update to image filters in the 6.6 release, we improved the quality of the resizing and rotating 
images when the resizeQuality was set to "normal". This brought all platforms into line with the way things 
were on Mac pre 6.5. 


However, this change in image filter meant that resizing of images was more processor intensive and the 
resulting output was much smoother. As developers using the "normal" resizeQuality relied on the time and 
output of the resize operation, we've decided to temporarily revert the "normal" behavior back to how things 
were in 6.5. 


This change is only temorary, with there being plans to fully address the issue in a future release where the 
resizeQulaity options will undergo and overhaul in order to provide the developer with greater flexibility. 


Some filesystem entries in the root of a volume on Mac report as files when they are 
really folders. (6.6.2) 


The 'net', 'home' and 'dev' folders do not report as folders in when using ‘the folders' - they appear as files 
instead. 


Memory leak in bitmap effects with spread of non-zero radius (e.g. spread 100%, radius 1; 
spread 50%, radius 2). (6.6.2) 


Specific bug fixes (6.6.2) 
(bug fixes specific to the current build are highlighted in bold, reverted bug fixes are stricken through) 
12443 import snapshot crashes LiveCode 
12434 iOS device builds rejected from app store due to XCode version in plist 
12418 Mail attachment from app file fails 
12414 Setting usePixelScaling causes infinite window reopening loop on Mac. 
12408 Encryption commands do not work for iOS device builds 
12385 Crash when modifying an unopened field. 
12382 Normal resizeQuality is slow 
12365 After "putting" return into a Field 
12350 The fontStyles is incorrect on iOS 
12341 Fix vGrid rendering for non-fixed-width table field mode. 
12319 Drag and drop going wrong when Display switched to 150% 
12294 Crash and flaky behavior at certain points. 
12286 Maximizing a window where only the title-bar is on-screen causes a crash on Mac. 


Rounded rects are drawn incorrectly when using the image editing tools with a linesize 
1 


12239 Magnification window shows corrupted image. 


12265 


12237 Attempt to attach to the launching console on Windows (if any) in standalones. 
12236 Dropdown menus are clipped on Windows when text scale > 100% 

12235 Tooltips clipped on Windows when text scaling > 100% 

12227 When Windows screen display is set to 125% popups sometimes break 


12223 


12210 
12206 


12200 


12185 
12183 
12182 
12175 
12173 
12170 
12146 
12125 
12107 
12105 
12101 
12099 
12088 
12058 


12044 


12037 
12027 
12020 
12010 
12008 


12006 


11975 
11964 
11933 
11920 
11904 
11895 
11884 


11860 


11748 
11708 
11690 
11689 
11662 
11603 
11370 
11072 
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Windows backdrop doesn't cover the full desktop area when displayed on a high-dpi 
screen. 

revBrowserSnapshot not working on Windows with IE9+ 

Buttons of menu type can't be inspected if first created object 

Some filesystem entries in the root of a volume on Mac report as files when they are 
really folders. 

Standalone engine crashes when -ui specified on Linux. 

Clicking in the scrollbar well doesn't work if the click is too short. 

‘the pageRanges' doesn't work on fields with more than 64K chars. 

Setting the usePixelScaling property doesn't update all windows on Mac. 

Styling does not work for certain iOS fonts 

Non-existant command line parameter variables ($) behave strangely with split. 
setting tabstops to 2 equal numbers and then turning vGrid on hangs LC 

put the executionContexts crashes LiveCode server 

exit causes livecode server to crash 

Livecode server crashed if you call paramCount() 

Graphics missing from imported Hypercard stack 

On awakening Android device from sleep 

The script editor doesn't scroll horizontally as text is entered 

The backdrop on Windows is always black 


Opaque groups do not completely draw their backgrounds when acceleratedRendering 
is enabled 


Slow-down in setting contents of fields on Windows since 6.1.3. 

On Retina Mac's scrollbars with small thumbs render smaller than they should. 
Caret is too thin on Retina displays. 

Windows engine hangs after multiple stack redraws. 

import screen snapshot on iOS creates image of incorrect size. 


HTTP (HTML) URLs encoded with anything other than a native character set are 
retunred incorrectly 


“import snapshot from rect ..." only imports part of the screen on Windows 
Spacing is incorrect for Windows scaled text 

effective textColor returns empty value for styled text 

Memory leak in bitmap effects with spread of non-zero radius (e.g. spread 100% 
Italic characters with underhang are clipped on windows 

mobileComposeMail missing attachment in Android (Android Mail) 

Stoked graphics clipped when printed 

uuid and randomBytes functions don't work on iOS when Encryption support is not 
included 


Crash when putting an empty string into an XML node using PutIntoXMLNode. 
Anroid apps only partially drawn after rotating device during lock sreen 

Once large scripts start scrolling the script editor 

ResizeControl is not sent when resizing images 

Round buttons are drawn incorrectly 

Backdrop not displayed on Linux 

Anti-aliasing inconsistent for 1 pixel lines and curves 

magnify and edit image crashes LC 
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8041 Only allow interaction with scrollbars on groups in browse mode. 
6400 On Mac 
2627 ~The machine() function returns "unknown" under Mac OSX 


Dictionary changes 


e The entry for create (command) has been updated. 

e The entry for do (command) has been updated. 

e The entry for export snapshot (command) has been updated. 
e The entry for find (command) has been updated. 

e The entry for plain (keyword) has been updated. 

e The entry for HTMLText (property) has been updated. 

e The entry for pagelncrement (property) has been updated. 

e The entry for textStyle (property) has been updated. 
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